                       XMT-O Reference Software
                       ========================

To build/use the XMT-O reference software
-----------------------------------------

The main java program is XmtO2A, which creates an XMT-A file from XMT-O that can
be compiled in an mp4 file.  To compile the XMT-A into mp4 requires the XMT-A
reference software.

To build we recommend using Java 1.2 or above. Compile XmtO2A and all the
files in the folders xmto2xmta and xmtutil. Set the classpath to the use the
xerces.jar.

For the current release use the one provided. This is a compiled version of
the latest Xerces and is not an official version release yet (this has a bug fix
for defaulted attributes that is not yet in an official release).

If the XmtO2A program is run with no arguments as follows, it produces the
subsequent help message

  java -cp xerces.jar;. XmtO2A

  This program validates a XMT-O file and/or converts it into a XMT-A file.

    Usage: XmtO2A  <XMT.xml> [-a <XMT-A.xml>]
                             [-l <logfile.xml>]
                             [-x] [-v] [-?]

    <XMT.xml>      - input XMT-O file name.
    <XMT-A.xml>    - optional XMT-A file name.  If one is not provided then the
                     XMT-A file will have the XMT-O file name with 'A' appended.
    <logfile.xml>  - optional xml file name where messges will be logged. If one
                     is not provided then any message will be printed on the
                     console.
    -x             - optional flag for validation only. If present, the XMT-O
                     file will be validated but not converted into XMT-A.
    -v             - optional flag for no validation.If present, no validation
                     of the XMT-O file will be performed before conversion.
    -?             - this help information.


so for example to convert the XMT-O IBMAnimation test case that has been
provided into XMT-A

  java -cp xerces.jar;. XmtO2A test\ibmxmt\IBMAnimation\IBMAnimation.xml

and this will create an IBMAnimationA.xml XMT-A file in the same folder as the
XMT-O.

The XMT-A file can then be subsequently converted to mp4 using the XMT-A
reference software.
